home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / cpcug.zip / SETUP.DOC < prev    next >
Text File  |  1987-04-20  |  6KB  |  107 lines
  1.           SETUP                                     Jeff Prosise
  2.           Command
  3.           Copyright (c) 1986, Ziff-Davis Publishing Co.
  4.           ______________________________________________________
  5.  
  6.           Purpose:  Permits menu-oriented selection and immediate
  7.                     transmission of printer control codes from
  8.                     within a running application program.
  9.  
  10.           Format:   SETUP            (loads command into memory)
  11.                     <Ctrl-Right Shift>          (activates menu)
  12.                     <[Shift]<Fx>      (selects [deselects] mode)
  13.                     <Esc>            (activates selection(s) and
  14.                                  returns to application program)
  15.  
  16.                     Fx is a Function key (F1 through F10) that
  17.                     sends the required control sequence to the
  18.                     printer.  Shift-Fx toggles the selected
  19.                     printer mode off.
  20.  
  21.           Remarks:  After loading SETUP (normally via your
  22.                     AUTOEXEC.BAT file), the printer mode
  23.                     selection menu program is displayed by
  24.                     pressing the Ctrl-Right Shift key
  25.                     combination.  This can be done from within
  26.                     application programs that do not take over
  27.                     the keyboard interrupts; the application is
  28.                     simply suspended until you leave SETUP by
  29.                     pressing the Esc key.  (Application programs
  30.                     such as XyWrite III that do take over the
  31.                     keyboard interrupts can be used with
  32.                     SETUP.COM if they themselves provide the
  33.                     option of temporarily returning to DOS
  34.                     control.)
  35.  
  36.                     Printer permitting, more than one mode can be
  37.                     selected at once by pressing additional
  38.                     function keys.  The default printer choices
  39.                     are for the Epson RX/FX series.  Option 1
  40.                     shows how to modify the program for other
  41.                     printers.
  42.  
  43.                     Notes:
  44.  
  45.                     1.   SETUP.COM is a memory-resident program
  46.                          (approximately 3K in length), and so is
  47.                          subject to conflicts with other memory-
  48.                          resident software.  Several users have
  49.                          reported that it is incompatible with
  50.                          Prokey, for example.  Similarly, while
  51.                          SETUP.COM is compatible with SideKick,
  52.                          the combination of SuperKey and SideKick
  53.                          has been reported to be incompatible.
  54.  
  55.           Option 1: If you have access to an IBM or Microsoft
  56.                     macro assembler, the easiest way to modify
  57.                     SETUP for other printers (or to use LPT2: or
  58.                     LPT3: instead of LPT1:) is to modify the
  59.                     SETUP.ASM file (available for download from
  60.                     the PC Magazine Interactive Reader Service
  61.                     (IRS) BBS (212) 696-0360) in any ASCII word
  62.                     processor.  You can then make your
  63.                     modifications and reassemble the file.
  64.                                  Page -1-
  65.  
  66.                     Even if you do not have a macro assembler and
  67.                     must therefore use DEBUG.COM to modify
  68.                     SETUP.COM directly, print out and read the
  69.                     SETUP.ASM file.  It is heavily commented, and
  70.                     will give you a good idea of how the
  71.                     different menu strings and printer control
  72.                     strings are organized.  Note, however, that
  73.                     the specific values shown in SETUP.ASM are in
  74.                     decimal notation; values entered via DEBUG
  75.                     must be in hexadecimal notation.
  76.  
  77.                     The following offset addresses, not those
  78.                     originally published in PC Magazine, should
  79.                     be used:
  80.  
  81.                     The menu color attributes (4F and 70) are at
  82.                     offsets xxxx:013F and xxxx:0140.
  83.  
  84.                     To change the port number from LPT1: to LPT2:
  85.                     (or LPT3:) change the default 00 at xxxx:0C7A
  86.                     and at xxxx:0C84 to 01 (or 02).
  87.  
  88.                     The start of the menu text table (532 bytes,
  89.                     beginning with C9) is at offset xxxx:0151.
  90.                     The "P" in PRINTER SETUP MENU" is at
  91.                     xxxx:0172.
  92.  
  93.                     The printer control strings themselves begin
  94.                     at xxxx:09A1.  Each function key (and each
  95.                     shifted function key, with the exception of
  96.                     F19 and F20) can be assigned a string up to
  97.                     16 bytes long.  Each string must include a
  98.                     delimiter of FF (255 decimal) that marks the
  99.                     end of the string.  The beginning of the
  100.                     string for each successive function key
  101.                     starts at an address that is a multiple of 16
  102.                     bytes above the base address (xxxx:09A1) of
  103.                     the table.  You must pad the strings with
  104.                     zeros for any locations that are not used by
  105.                     actual control codes, so that each string
  106.                     begins on a 16-byte boundary.
  107.